Patch Creation Utility : content
 Patch Creation Utility Help Index

The Patch Creation utility allows you to create self-contained and (optionally) compressed patches for files already on the end-user’s machine.  You can use it, for example, to update registered users of your software.  Only registered users will be able to use the patches created using this program since the files on the machine are used to create the updated version.  Other patch programs use a command line interface rather than a GUI and are not very user-friendly.  They are also overpriced (see Ordering Information).  The Patch Creation Utility allows you to create the Patches in a GUI environment and the resulting program is also a GUI, easy to use program for Windows 95, NT or 3.1x.  Please note that the Patch Creator can only be used in Windows 95 or NT.  See Patch Creation Utility Main Window and Options dialog for more details on the product’s features.

How to...

Create a Patch	- Select (using the ... Browse buttons) the Old Path (place where the files to be patched reside) and the New Path (place where the files to be produced by the patch reside). - Push the Get File List button to produce a preliminary list of the files found in the two directories (and their subdirectories if any). Highlight any item in the list you would like to Edit, Remove, Move Up or Down or Insert before, then use the appropriate button. - When you are satisfied with the list, check the Options to make sure the program name, password, file to search for and default directory where files may be on the user’s machine. - Finally, after making sure the Patch File field is correctly filled in, enter the patch settings in the Options dialog, then push the Make Patch button.

Topics

Patch Creation Utility Main Window

Options dialog

Edit Patch Item Dialog

About dialog

Ordering Information

License Information

Acknowledgements

Copyright 1996-1997 Funduc Software Inc.


Patch Creation Utility : Main Window
Patch Creation Utility Main Window

This window allows you to create a list of files to be patched and to create the patch.  Your last settings are saved for convenience.

Old Path Field

You must enter a directory where the files to be patched reside on the machine used the create the patch.  The files can be in multiple subdirectories.  In that case, specify the root of those subdirectories.

New Path Field

You must enter a directory where the new files to be used for the patch reside on the machine used the create the patch.  The files can also be in multiple subdirectories.  In that case, specify the root of those subdirectories.

Patch File Field

You must enter a patch file name to be created.  You can use the ... button to get a Save As dialog.

Get File List Button

After both the Old and New Path are entered, you can produce a list of files to be patched by pushing this button.  You can then modify the list and push the Make Patch button.

Make Patch Button

After both list of files to patch is finalized, you can push this button to generate the file specified in the Patch File field (see above).  See the Options dialog for patch creation settings.

Close Button

You can push this button to close the application.

Results List

After you push the Get File List button, this list is populated.  You can then edit it using the Edit, Insert, Remove, Move Up and Move Down buttons.

Edit button

Highlight (select) a row in the Results List and push this button to edit it. Edit Patch Item Dialog will then be displayed.

Remove button

Highlight (select) a row in the Results List and push this button to remove it.

Insert button

Highlight (select) a row in the Results List and push this button to insert it in the list and edit it.  The Edit Patch Item Dialog will then be displayed.

Move Up button

Highlight (select) a row in the Results List and push this button to move it up by one row in the list.

Move Down button

Highlight (select) a row in the Results List and push this button to move it down by one row in the list.


options: configuring the resulting patch program
Options dialog box

This window allows you to enter information to be used in the creation of the resulting Patch Applicator program.

Password Field

You can enter a password between 4 and 12 characters.  It is not masked so that you can see its contents.

Use Compression Box

Generally, you would want to always use this option since it reduces the size of the resulting Patch Applicator program.

Patch for Windows 95/NT only

If your users are running Windows 3.1x DO NOT check this box.  If you do, the resulting Patch Applicator program can handle long file names but is larger.

On the other hand, if any of the files involved have long file names, you MUST check this box.

Patch Name

Please enter the name of the program you are trying to patch.  For example: Search and Replace (http://www.funduc.com).

Setup Path Field

If the setup utility you use to install the program has a default directory, you may enter that path.  The Patch Applicator program will then look in that directory for the file entered in the Find File field (see below) and ask the user if the program is installed there.  This field is optional.

Find File Field

If the setup utility you use can look for a key file to determine where the patch can be applied (sometimes the patch is run from where it must be applied), you can specify what file name to look for.  The Patch Applicator program will then look in the current directory and the Setup Path directory (see above) for the file and if it is found, it will prompt if the location is correct, then apply the patch.

OK button

The settings are saved will be made.

Cancel button

The changes will not be made.


editing a file to be patched
Edit Item dialog box

This window allows you to change the way a file is patched or add a new file to the list.  An Update operation will use the old file, compare it to the new file and only add the portions that have changed.  An Add operation will add a file completely, a Rename will rename a file and a Remove will remove a file from the user’s machine.

Old File Name Field

The Old File Name to patch from.  This file must exist on the machine where the patch is built for an Update or Remove operation.

New File Name Field

The New File Name to patch to.  This file must exist on the machine where the patch is built for an Update or Add operation.

Target Name Field

This field must contain the name and relative path from where the patch is applied on the user’s machine.  This field must be filled in for all operations:

	• For Update, this field contains the expected name and relative location of the correct file to be patched.
	• For Add. this field contains the expected name and relative location of where the new file will be written.
	• For Remove, this field contains the expected name and relative location of the file to be deleted.
	• For Rename, this field contains the previous name and the new name and relative location of the file.
Rename From Field

This field must contain the old name and relative path from where the patch is applied on the user’s machine.  This field must be filled in for the rename operation.

Patch Operation Field

This group of radio buttons allows you to specify the operation to be performed on the file.  It can be Update, Add, Rename or Remove.

OK button

The settings are saved will be made.

Cancel button

The changes will not be made.


About Patch Creator for Windows
About Box

This window contains system and copyright information.  Click the Ordering Info button for

Ordering Information or the License Info button for License Information.

For customer support, contact support@funduc.com.


Ordering Information

As part of the registration, you will also receive free updates and customer support (by E-MAIL) for a year. If you have problems receiving the program or need customer support, contact us directly by E-MAIL at support@funduc.com or visit: http://www.funduc.com.

•	Ordering by check:  To order by check send this order form and a check for $75 (+$3-$5 if you want a diskette mailed) to Funduc Software Inc., P.O. Box 530904 Livonia, MI 48153.   Please allow 7-10 days for mail to reach you, then contact us by E-MAIL if you did not receive the program. To print this order form, click on Print Topic in the File pull-down menu or print the ORDER.TXT file. Payments must be in US dollars drawn on a US bank or international postal money order in US dollars.

•	CompuServe subscribers may register by typing GO SWREG and using the Registration ID 14920 (the cost is also $75/user + $3 - $5 S&H).  To receive the registered version by E-MAIL, send a message after registering to: support@funduc.com.

•	To register using a credit card by Fax, call: (813)526-2924.  Specify order is for Patch Creator. The cost through this option is $75/user + $3-$5S&H if you want a diskette mailed (E-MAIL delivery is free). If you want, you can call (800)500-0326 or (352)315-6330 to order.

Please check one:	__ E-MAIL(please include your address)
	__ 3.5" Disk (please add $3 or $5 for S&H below)
Patch Creator for Windows ____    copies at $75 each	_______
Michigan residents add 6% sales tax	_______
For snail mail delivery (3.5" disk) in the United States  add $3.00 or $5.00 for  overseas	_______
Total payment	__________

Prices subject to change without notice.

            Name: _______________________Date:___________

         Company: _______________________________________

         Address: _______________________________________

City, State, Zip: _______________________________________

         Country: _______________________________________

       Day Phone: _________________Eve:__________________

                 FAX:__________________

Electronic Mail address: ________________________________

How did you hear about Patch Creator for Windows?

__________________________

Comments:


Licensing Information
License Information

Copyright/License/Warranty

For ordering information, see the section Ordering Information.

Patch Creator for Windows Copyright (c) 1996-1997 by Funduc Software Inc. - All rights reserved.

License Agreement and Warranty Disclaimer

You should carefully read the following terms and conditions before using this software.  Use of this software indicates your acceptance of these terms and conditions.  If you do not agree with them, do not use the software.

Shareware Version

You are hereby licensed to: use the Shareware Version of the software for a 21 day evaluation period; make as many copies of the Shareware version of this software and documentation as you wish; give exact copies of the original Shareware version to anyone; and distribute the Shareware version of the software and documentation in its unmodified form via electronic means.  There is no charge for any of the above.

You are specifically prohibited from charging, or requesting donations, for any such copies, however made; and from distributing the software and/or documentation with other products (commercial or otherwise) without prior written permission.

Creation and distribution of patches with the Shareware version of Patch Creator for Windows is in violation of federal copyright laws.

Evaluation and Registration

This is not free software.  This license allows you to use this software for evaluation purposes without charge for a period of 21 days.  If you use this software after the 21 day evaluation period a registration fee is due (see Ordering Information).

Customer support can be obtained by visiting our homepage at http://www.funduc.com or or by E-MAIL (support@funduc.com).

One registered copy of Patch Creator for Windows may be dedicated to a single person who uses the software on one or more computers or to a single workstation used by multiple people.

You may access the registered version of Patch Creator for Windows through a network, provided that you have obtained individual licenses for the software covering all workstations that will access the software through the network.

Governing Law

This agreement shall be governed by the laws of the State of Michigan.

Disclaimer of Warranty

This software and the accompanying files are sold "as is" and without warranties as to performance of merchantability or any other warranties whether expressed or implied.  In particular, there is no warranty for the string Replacing feature.

Good data processing procedure dictates that any program be thoroughly tested with non-critical data before relying on it.  The user must assume the entire risk of using the program.  Any liability of the seller will be limited exclusively to product replacement or refund of purchase price.


Select Path dialog
Select Path dialog box

Directories

Select the directory where the files you want to view reside.

Drive

Select the drive where the files you want to view reside.

OK button

The path you selected will be used.

Cancel button

The path will not be changed.


File Open dialog
File Open/Select Viewer dialog box

File Name

Select or type the name of the document you want to open. This box lists documents with the filename extension selected in the List Files Of Type box. To see a list of files with a particular extension, type an asterisk (*), a period, and the three-character extension, and then press ENTER. To see files with more than one filename extension, type a semicolon (;), a second asterisk (*), a period, and another three-character extension. For example, if you

want to see all files with the .TXT extension and all files with the .INI extension, type *.txt;*.ini.

List files of Type

Select the type of files you want to see in the File Name list.

Directories

Select the directory where the files you want reside.

Drive

Select the drive where the files you want reside.

OK button

The File you selected will be used.

Cancel button

The File will not be used.


File Save dialog
File Save dialog box

File Name

To save a document with a new name, in a different file format, or in a different location, type a new filename.  To save a document with an existing filename, select the name in the list or type the current name.

Save files of Type

Select the type of files you want to see in the File Name list.

Directories

Select the directory where the files you want to search reside.

Drive

Select the drive where the files you want to search reside.

OK button

The File you selected will be used.

Cancel button

The File will not be used.


Acknowledgements

The portion of the Patch Creator and Patch Applicator that compresses and decompresses patch files is based on the work of the Info-Zip group and used with their permission.  Thanks to the entire Info-Zip group, in particular to Jean-loup Gailly, Greg Roelofs, and Mark Adler. If you are interested, you can obtain the Info-Zip code from many sources, including: CompuServe, ibmpro forum; BIX: ibm.pc listings; Internet, ftp.uu.net:/pub/zip.  If you cannot obtain this file from other sources you can send a self-addressed-stamped envelope with a disk to the address in the "About" dialog box.


No Help Available

No help is available for this area of the window.


No Help Available

No help is available for this message box.